Mention gtk_button_set_image() and friends in the migration docs

The image-related API for GtkButton has been dropped, but still needs
to be mentioned in the migration guide.

Closes: #21

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 46327e43af542f98c48cc26966a197fdadfc0351..a162b5e5f0389382c4f4fbb0209526fc452726de 100644 (file)
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -157,6 +157,18 @@
       </para>
     </section>
 
+    <section>
+      <title>Stop using GtkButton's image-related API</title>
+      <para>
+        The functions and properties related to automatically add a GtkImage
+        to a GtkButton, and using a GtkSetting to control its visibility, are
+        not supported in GTK+ 4. Instead, you can just pack a GtkImage inside
+        a GtkButton, and control its visibility like you would for any other
+        widget. If you only want to add a named icon to a GtkButton, you can
+        use gtk_button_set_icon_name().
+      </para>
+    </section>
+
   </section>
 
   <section>